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A Review of Apple's Lisa WorkShop 


by 
David Craig 
736 Edgewater, Wichita KS 67230 


( October 12, 1968 ) 
INTRODUCTION 


The WorkShop was Apple's software development environment for the Lisa during the 
years 1981 ta 1985. From 1981 to 1983 this environment produced all the code for the 
Lisa. After Apple's Macintosh introduction in 1984 Macintosh developers used the 
WorkShop since no native Macintosh development environment existed. 


The WorkShop is a command tine shell similar in appearance to Apple's older Apple // 
and /// UCSD- like Pascal shells. The main command line provides access to two other 
command lines, the File Manager and the System Manager, and to several ee 
tools. The programming tools consist of an editor, Pascal compiler, 68000 assembler, 
and a linker. Even though the WorkShop supports various languages it Is really tailored 
toward Pascal since most of its utilities are for Pascal source code and object files. The 
main command line appears as 


{V3.9} WORKSHOP: FILE-MGA, SYSTEN-HGR, Edit, Run, Debug, Pascal, Basic, Quit, ? 
with the other half of this line being 
Assemble, Generate, HakeBackground, Link, TransferProgran 


FILE MANAGER 


The File Manager provides access to files which are stored either on 400K 
microdiskettes, hard disks, or tape backup systems. The Lisa Operating System 
supports a hierarchical file structure which the WorkShop also supports. The command 
line for the File Manager appears as 


FILE-NGR: Backup, Copy, Delete, List, Online, Prefix, Rename, Transfer, Quit, ? 
with the other half of this line being 
AddCatalog, Equal, FileAttributes, Initialize, Mount, Names, Scavenge, Unrount 


With this cormmand line you could backup. copy, and delete files. Wildcard characters 
within file names are supported for easier file selection. For a directory listing the 
List command displays a listing complete with file sizes, creation and modification 
dates, and file attributes. A sample follows: 


Size Psize Last-Mod-Date Creation-Date Attr 


10/02/88-10:52 SC 
16:20 12/03/87-23:40 06 


: 62944 : 4 : 
CARTOG/U01 ditapligr . 08.) 1 4 4 10/09/88-15: 21 


CARTOG/UO1 dHapligr. TEXT 10/08/88-16: 34 09/11/88-18: 21 
CARTOGX. TEXT 09/29/88-14: 41 09/08/88-23: 37 


A Review of Apple's Lisa WorkShop «1> 


“LisaWkShopReviewDT COct88 1.PICT” 355 KB 1999-02-01 dpi: 360h x 363v pix: 2397h x 3634v 


@ Apple Lisa Computer Technical Information Page 0002 of 0009 


@ Apple Lisa Computer: Workshop Review (DTC 1988) 


565 total blocks for files listed ey 
94 blocks of 0S overhead for volune and files listed 
1115 blocks free out of 17418 


The attributes field specifies the attributes of a file. These are defined as follows: 
- File is currently open 
¢ - File was closed by the ee Pgs te Systen 


$ - File has its Safety f 
P ~ File is Protected feat caine 


The Online command displays a list of the currently mounted devices as follows: 
DevWane DevAlias § VoluneNane VolSize FreeBlks Files Open attr 
17418 
12 


0 
RS232 <prir 0 
SLOT2CHANI ProFile 9690 


The AddCatalog command creates a new subdirectory, Equal compares files for 
equality, and Initialize formats disk volumes. The Scavenge command analyses disk 
volumes for irregularities and repairs them if any problems exist. Mount and Unmount 
make external devices visible to the Lisa Operating System and the WorkShop. The 
FileAttributes command produces the following command line: 


File Attributes: ClearAttributes, Protect. Safety. AddPassword, RenovePassword, Quit 


This command line deletes or specifies new file attributes. The Safety command marks 
a file as non-deletable so that if you try and delete it the delete will fail. This attribute 
is very useful for important files. Protect marks a file as protected so that the file can 
never be copied. This attribute was used by the Lisa Office System (a.k.a. Lisa 7/7) to 
turn programs into “protected masters". AddPassword and RemovePassword allow 
file password protection. 


SYSTEM MANAGER 


The Systern Manager provides access to several low-level features of the Lisa. Its 
command line is 


SYSTEH-HGR: ManageProcess, OutputRedirect. Preferences. Tine. Quit. 7 
with the second half appearing as 
Console. FilesPrivate. Validate. DefaultPrinter 


ManageProcess lists all the current system processes and can terminate executing 
processes. OutputRedirect redirects all console output to a text file whose name you 
specify. Preferences runs the Lisa Preferences tool which appears as a window with 
buttons that are mouse controlled. This window allows you to specify several hardware 
parameters of the Lisa such as the screen brightness, speaker volume level, and keyboard 
and mouse sensitivity. Time displays the current clock date and time. Console allows 
the WorkShop's main console I/0 to originate from either the alternate console or an 
external terminal connected to one of the Lisa's serial ports. FilesPrivate enables the 
File Manager to have access to special Office System files whose names start with "{". 
Generally WorkShop programs should not access these files since their integrity is vital 
for correct operation of the Office System. 
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The Validate command controls several of what are called “paranoia” settings, such as 
whether file transfers will be verified and whether file selections will require user 
confirmation for File Manager operations. This allows you to tailor the system to your 
level of confidence in it and in yourself. 


PROGRAMMING TOOLS 


The Lisa WorkShop supports several powerful programming tools. Access to these is 
available through the main command line. The commands in the line for the tools are 


Edit, Debug. Pascal. Basic, Assemble, Generate, Link 


The first tool that is usually used is the source code editor. The editor, called LisaEdit, 
provides full window, menu bar, and mouse support. Menus exist in a menu bar which 
supports pull-down menus. These handle file creation, opening, saving, and printing. In 
an early version of LisaEdit the print menu supported underlining of Pascal keywords. 
Unfortunately, later versions eliminated this handy feature. Multiple overlapping and 
resizable windows are available for editing source code files with file size limited only 
by the arnount of memory your Lisa has. With my 1 Mbyte system | have had been able 
to work with about a dozen large programs. Text resizing is available through the Type 
Style menu. You can have very small text with about 150 characters per line (cpl) to 
very large text with about 60 cpl. Cutting and pasting is done with the mouse and the 
Edit menu which supports the commands Cut, Copy, and Paste. The Lisa's arrow keys on 
the keypad are supported for cursor movement. The Undo menu command provides the 
ability to “undo” your last operation. For example, if you Cut some text that was not 
supposed to be cut Undo will undo the Cut. When you leave LisaEdit and return to the 
WorkShop main command line the opened windows in LisaEdit remain active. Later, 
when you reenter LisaEdit the windows appear automatically. This is very handy for 
modifying a program, leaving LisaEdit to compile the program, and returning to 
LisaEdit. 


The Pascal Compiler is the heart of the Lisa WorkShop. For a detailed review of this 
compiler’s features see my paper titled “A Review of Apple's Lisa Pascal". This 
compiler generates I-code (intermediate code) which is actually only standard UCSD 
Pascal P-code. If an error occurs during a compilation the editor is run, the source file 
is loaded, the cursor is placed over the offending statement. and a specific error 
message is displayed. The Code Generator, which is run automatically by the 
Compiler, takes an I-code file and produces 68000 object code. The Linker links 
different files and libraries to create executable object files. The Compiler and Code 
Generator display a lot of compilation statistics as the following example shows: 


Lisa Pascal Compiler v3.76 (05-Apr-85) 10:50: 46 10-Oct-88 
(¢)1981 SVS, Inc. (c)1983, 1984 Apple Computer, Inc. 


Input file ~_[. TEXT) RangeTester 
List file - [. TEXT] 

Output file - [RangeTester] [.08J] 
[242109 words] RANGE_TE 


Elapsed tine: 5.901 seconds. . 
Compilation complete - no errors found. 9 lines. 
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Lisa Pascal NC68000 Code Generator ¥3.65 (20-Mar-85) 10:51:00 10-Oct-68 
(c)1981 SVS, Inc. (c)1983, 1984 Apple Computer, Inc. 


Input file - fe 
Input file - [.1) RengeTester 
Output file - [RangeTester} [.06J] RangeTester 


RANGE_TE - RANGE_TE Code size = 88 


Elapsed tine: 2.580 seconds. 
Total code size = 088 


Linker ~ 68000 Object Code v0.9. 3.1 08-Apr-85 15: 26:15 
ae Apple Computer, Inc. 1985 


er inter ati aaa 
Mer initial a ea mais 233146 
ape file Ae 08] 


Options ire: 
Option Value Description: 


Alphabetical Listing 
hed nodule into segnent 


r donain 
Initial Stack ob Area: 0% 
Interfaces Flag 
Location Ordered Listing 
tolane Segnent Nane Mapping 
Enit 0.S. Data record 


+P -P = yet Link, machines w/out MMU‘s. 
*R-R Oe! E Do partial link 
If MOONAME is provided. dead code will be stripped using it as the root 
*S nun Start Dynamic Stack Size: 10240 
*T nun Top Dynamic Stack Size 131072 
+ Which directory file: “AZ INTAINGIC. LI8 
4X -X ‘+ onlay HAC 
Options 7 
Input file Tester 
SLIO 


soce) ( Raoefeste Att) 


tor co 
‘ASLIB. a) 


Linking fain rope 

Reading Library rec tory: -#12-INTRINSIC. LIB 

Active : 1 of 19 read 

Visible: 1 of 11 read. 

Global data: 16 

Connon data: 

Nunber of segrents in me ic number of ~e. i= entries = 1 
Linking segnent: e (JT) seg: 1 size 86 

OD Errors detected. 

RangeTester.08J is an executable progran file. 


Elapsed tine: 24.210 seconds. 
That's all Folks! 


The Pascal Compiler supports many directives which modify its behavior. For example, 
you can control integer and sub-range checking, short-circuit boolean evaluation, code 
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optimization control (i.e., off, old scherne, new scheme), program routine name 
inclusion into the object code for debugging with LisaBug, assembly language listing, and 
conditional compilation. The last item is implemented using the following directives: 
ECL var_i pane} declares var_| pee to be a aan ine varies 
ETC var_nane := expression} sets var_nane to a boolean or an int 
IFC poression on} tests if expression is true. if true ee Iles fo Following code 
ELSEC} then-el 


the else part in the if- 
the endif part in the if-then-else-endif conetruct 


The assembly listing shows the generated assembly code listed after each source line. 
The listing for a simple Pascal program follows: 


Lisa Meter ler ¥3.76 (05-Apr-85) 10:51:45 10-Oct-88 
Lisa Pasc. Code Generator V3.65 (20-Mar-85) 10:51:57 10-Oct-88 


PROGRAM Range_Tester; {$ASH+} 
VAR a: ARRAY (0..9] OF INTEGER; 
1: 0.10: 
EDR Gu &_BEGIN 
6, 
(a7)+, 6 
SH). Al 


-B8 SFFEBCAS) 
BRA. $ (0001 


MOVE.B SFFEB(AS),00 
EXT.W DO 
CHK 


000026 £340 ASL.W ot 00” 
1220 FFEB MOVE.B SFFEB(AS).01 
00002C 4961 


EXT.W 
QO002E 3881 CDEC HOVE.W if . SEC(AS, 00. W) 
000032 $220 FFEB ADDQ. 8 ni spre) 
000036 0C2D OOGA FFEB 10001  CHPI.6 
GFOE BLE.S 10002” 
JSR & TERM 
aS 
*_EMO 


OO004E 0241 4€47 455F . WORD 41, $4647, gale aie . 


000056 0000 CstSize .WORD Last-CstSize-2 
000058 Last 
9 9 -0 END. 


Elapsed compilation tine: 3.197 seconds. 
pore tiation lee no errors found. 9 lines. 
code genera seconds. 


Elapsed tor tine: 4.075 
Total code size = 068 


The 68000 Assembler is used to create assembly routines which will later be linked to 
a Pascal program. Assembly is really used only for time or space critical code. 


The Lisa WorkShop supports several other languages which must be purchased 
separately. AC Compiler was created shortly after the Lisa was introduced, but little 
programming effort seems to have been done with C due to the Lisa's overal! Pascal 
perspective. LisaBasic was a rewrite of DEC's Basic-PLUS language, but since 
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LisaBasic was an interpreter its use never caught on with programmers. LisaCOBOL 
appeared but was shortly forgotten. One interesting language which Apple developed for 
the Lisa but was never announced or released was Magic/L (pronounced “magical"). 
This language was a combination between Pascal and Forth. which | assume Apple Inc. 
found too exotic even for their revolutionary Lisa. 


Debugging Lisa programs is accomplished in either of two ways. The preferred method 
for Pascal and other high level languages is to write debugging data to the Lisa's 
alternate console. This console, whose device name is “-ALTCONSOLE", is displayed when 
the Right-Option and Keypad-Enter keys are simultaneously pressed. While a program 
is running it displays debugging data on the alternate console using Pascal's WRITELN. The 
program's execution continues even when this console is displayed. To debug assembler 
or compiled code LisaBug exists. LisaBug uses the alternate console for both input and 
output. To debug a program use the Debug command from the main command line and 
you will be asked for the name of the file to debug. A breakpoint is set at the first 
instruction of the program and you can then single step, trace, or disassemble the 
program using various LisaBug commands. Routine names or symbols are available if 
the compiler's debugging directive, {$¢D+}, was enabled. When a runtime error occurs in 
a WorkShop program LisaBug is invoked. For example, the following Pascal program 
contains a runtime range error: 


PROGRAM Renge_Tester: 
VAR a: ARRAY [0..9} OF INTEGER: 
1: 6..10; 


BEGIN 
ae 2 oS TO 10 00 «={ <--- Famtine error occurs when i = 10 } 
7 


When this program runs the Lisa displays the following information on the alternate 
console and makes this console visible: 


Level 7 i as 
sae TL oe E ASL. 51.00 
PC E SR=0000_ 0 ~US=O0F7FAEG SS=O0CBFECO DO=1 P#=0008 
D0=0000000A 01=00000009 02=0000F FFF 03=00000001 
O6=00F 7080C 07=00CC91E2 
AD=A0220E 1A A1=D0CC91E2 A2=00CEDDAC A3=00009042 
A4=00CC9042 AS=OOFTFC4A AG=00FTFC4A AT=O0F TFAEG 


CHK RANGE ERROR in process of gid 0 
Staved registers at 13364270 
TS a 
to Lisabug, type o to continue 


You are now in LisaBug and can issue LisaBug cormmands. For example, to see the 
program type "IL RANGE_TE" and the following appears: 
>IL RANGE_TE 


RANGE_TE+D000 4€56 0000 RANGE_TE LINK Mine 
¢, 


SUBA.L $0010(A5), AT 

TUISR 

CLA. 8 FLER(AS) 

£+0016 601A BRA. S$ **$001¢ 

RANGETE+O018 1020 FFES MOVE. B R; FEB(AS), DO 
RANGE TE*001C 4980 EXT.@ 
RANGE_TE+O01E 418C 0009 
RANGE TE+0022 E340 


; 0002003E 
CHK .00 
ASL.W S100 
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RANGE _TE+0024 1220 FFED nOvE.B SFFEB(AS), 
—TE*0028 4681 EXT. W 
WOVE. WD}. SEC(AS. DO. W) 


ADDO. B #$1, FFEB(AS) 

CHPI.B #5000A, $FFEB(AS) 

BLE.S *-' ; 0002002 
VJSA_$00220290 ; 


This assembly listing shows in line RANGE_TE+0022 that the program crashed with a range 
error (CHK RANGE ERROR) since variable i was greater than 9, the last index in array a. 


LisaBug can also be invoked at any time by pressing the “—“ key on the keypad. This is 
useful when a program is in an infinite loop situation and nothing will make it stop. 
Once in LisaBug you can terminate the errant program and return to the WorkShop main 
command line. 


For Macintosh prograrmmers Apple developed the WorkShop Macintosh Software 
Supplement. This consisted of a set of Lisa diskettes containing Macintosh ToolBox and 
OS interfaces which allowed total access to every Macintosh feature. Various 
Macintosh oriented tools for the WorkShop were also provided. This included a resource 
editor and a resource compiler. For more advanced Macintosh programming Apple 
released several preliminary versions of MacApp, an object-oriented programming 
environment centered around the Object Pascal language. MacApp was based upon 
Apple's work with ToolKit/32, an ambitious object-oriented system based upon Clascal, 
the predecessor to Object Pascal. ToolKit/32 and Clascal were never supported by 
Apple since when both of these were near completion Apple diverted its resources 
toward the Macintosh and away from the Lisa. 


EXEC FILES 


The program development cycle for a typical application involves a lot of typing. To 
ease programmers of this burden the WorkShop allows command line input to come 
from special files, called Exec files. These files are similar to Apple's alder /// Pascal 
Exec facility, but the Lisa version allows Exec files to be created with the editor. The 
Lisa Exec facility evolved into a very sophisticated Pascal-like language that supports 
variables, boolean expressions, loops, comments, and file I/0. A simple example 
follows which compiles two units & a main program, links these items, and runs the 
final executable file: 


EXEC 

ET 80 TO ‘CARTOG/Hap_Util' nein progren file} 
SET 81 TO ‘CART * { new map file nenager unit } 
ET &2 TO ‘CARTOG/UOLdMaptigr ‘ 010 Rap file manager unit 


{ascal} 42 { compile the old nap ranager unit } 
P{ascal} %1 { compile the new Rap nanager unit } 


P{ascal} 20 { compile tne rain progran } 


L{ink} %0 ’ { link the rain progran } 
$1 { link the new Rap Ranager unit } 
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1ink the old Rap manager unit } 
link ry virtual nerory ae } 

link ay runtine debugger unit 

link the Lisa Pascal runtine unit } 


: { send Linker output to the rain prograa } 
R{un} §=6-- 8s {_ run the main progran } 
EMDEXEC { That's all. Folks ... } 


LANGUAGE UTILITIES 


The WorkShop contains many useful utilities which assist programmers greatly. These 
utilities disassemble compiled programs, edit files at the block level, generate program 
cross-references, etc... The following table summarizes the more important utilities: 


shows the code sizes and nanes of program segnents 
disassenbles saigh Sapa fln or Sat code 
edits files at the b 
divides large files. fa eailey files 
joins files divided by FileDiv 

Searches text files for strings 
transfers files to and fron Lisa and Nacintosh nicrodiskettes 
fornsts Pascal aeutts files nany options 
shows the nanes and lexical levels of Pascal program routines 
compiles 8 res resource file for Macintosh programs 
Segitap shows the code segnents in a progran 
ShowInterface shows ae ancertace portion of a Pascal Unit object file 
UxRef shows the routine relationships in @ compiled progran 
KRef shows the variable/routine cross-references in a source file 


Two other features make the WorkShop well rounded. The TransferProgram command 
in the main command line runs a mouse- and window-based telecommunication's 
program. This is ideal for accessing a programming BBS and downloading source code. 
The MakeBackground command allows programs to be run as a background process. 
With this feature you can run several programs at once, but with several programs 
running concurrently system performance can become degraded. 


CONCLUSION | 

For the past decade | have worked with many different computers, from programmable 
hand-held calculators to mainframes and from 1984 onward | have used a Lisa for 
programming mainly in Pascal. Overall, | have found the Lisa WorkShop to be a very 
powerful development system for creating, compiling, and debugging large programs. 
Even when compared to the other machines that | have worked with the Lisa WorkShop 
still comes out as being both a professional and power ful development environment. 


<<< That's all, Folks ... >>> 
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